home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 008 / superman.arc / SUPERMAN.DOC < prev   
Encoding:
Text File  |  1986-02-26  |  20.6 KB  |  467 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                MANDELBROT COLORAMA
  16.  
  17.  
  18.  
  19.  
  20.                                COLOR GRAPHICS DEMO
  21.  
  22.                                        AND
  23.  
  24.                                MANDELBROT PROGRAM
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                TRIMARK ENGINEERING
  32.                               12402 W. KINGSGATE DR.
  33.                                KNOXVILLE, TN 37922
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                EQUIPMENT REQUIRED
  42.  
  43.                       IBM PC, XT, AT OR COMPATIBLE COMPUTER
  44.                                256K MINIMUM MEMORY
  45.                       COLOR GRAPHICS OR COMPATIBLE ADAPTER
  46.                              COLOR MONITOR DESIRABLE
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                MANDELBROT COLORAMA
  65.                                by  Marshall Dudley
  66.  
  67.  
  68.                                 TABLE OF CONTENTS
  69.  
  70.  
  71.         1.0  Introduction: MandelWhat?. . . . . . . . . . . . . . . . . 2
  72.  
  73.  
  74.         2.0  Display : A Picture is worth a thousand words. . . . . . . 3
  75.  
  76.              2.1  Starting the Display Function . . . . . . . . . . . . 3
  77.              2.2  BreakPoints, Automatic Selection. . . . . . . . . . . 3
  78.              2.3  BreakPoints, Manual Selection . . . . . . . . . . . . 3
  79.                   2.3.1  Banding, enable/disable, and top end . . . . . 3
  80.                   2.3.2  BreakPoints 1 and 2. . . . . . . . . . . . . . 3
  81.              2.4  Color Redefinition. . . . . . . . . . . . . . . . . . 4
  82.              2.5  Changing the Palette and Background colors. . . . . . 4
  83.              2.6  Using the Window Function . . . . . . . . . . . . . . 4
  84.                   2.6.1  PgUp & PgDn Keys - Window size adjustment. . . 4
  85.                   2.6.2  Arrow Keys       - Moving the window . . . . . 4
  86.                   2.6.3  Home Key         - No Window . . . . . . . . . 4
  87.                   2.6.4  Ins & Del Key    - Aspect Ratio Changes. . . . 4
  88.                   2.6.5  End Key          - Reading the Coordinates . . 5
  89.              2.7  Saving a VIEW of a picture  . . . . . . . . . . . . . 5
  90.              2.8  Exiting the Display Function. . . . . . . . . . . . . 5
  91.  
  92.  
  93.         3.0  Loading a VIEW file  . . . . . . . . . . . . . . . . . . . 5
  94.  
  95.  
  96.         4.0  Animation : Computer Store's Dream Demo. . . . . . . . . . 5
  97.  
  98.              4.1  Starting the Animate. . . . . . . . . . . . . . . . . 5
  99.              4.2  Saving the Animate File . . . . . . . . . . . . . . . 6
  100.              4.3  Changing the Palette and Background . . . . . . . . . 6
  101.              4.4  Exiting the Animate Function. . . . . . . . . . . . . 6
  102.  
  103.  
  104.         5.0  Creating a new Mandelbrot Plot : Like Being an Explorer. . 6
  105.  
  106.              5.1  Starting the Create . . . . . . . . . . . . . . . . . 6
  107.              5.2  Automatic Coordinates from Window function. . . . . . 6
  108.              5.3  Entering Coordinates. . . . . . . . . . . . . . . . . 7
  109.              5.4  Existing Filename Conflict. . . . . . . . . . . . . . 7
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                    PAGE 1 OF 7
  117.  
  118.  
  119.  
  120.  
  121.  
  122.         1.0  INTRODUCTION - MandelWhat?
  123.  
  124.              The Mandelbrot Set,   named for Benoit B. Mandelbrot of IBM, 
  125.              is  a  beautiful mathematically derived map of points on the 
  126.              complex plane.  The points that are in the set are much like 
  127.              islands on an infinite sheet of complex numbers.   Along the 
  128.              boundaries of these islands,  other points flee to infinity.  
  129.              Coloring  these  fleeting  points according  to  their speed 
  130.              yields  the beautiful plots called a  Mandelbrot.   Although 
  131.              the algorithm is relatively simple,  each point on the plane 
  132.              may  require several thousand multiplications and  additions 
  133.              to determine its value.
  134.  
  135.              Like islands seen from an airplane,  the shoreline is ragged 
  136.              and  complicated.  Also, as you zoom in on a point along the 
  137.              shore, the geometry changes but never becomes less  complex.  
  138.              In fact, as you keep looking closer the complexity continues 
  139.              to grow,  as many old shapes reappear and new ones come into 
  140.              view.  Welcome to the field of Fractal Geometry.
  141.  
  142.              The full Mandelbrot lies within a region of -2 to .5 on  the 
  143.              Real  (X) axis and -1.25 to 1.25 on the Imaginary (Y)  axis.  
  144.              This  plot is stored on the disk as MANDEL.PIC.   Increasing 
  145.              values  are plotted as you go toward the right (Real) or  up 
  146.              (Imaginary) the screen.
  147.  
  148.                                     Imaginary Axis     
  149.                                           | +
  150.                                           |
  151.                                           |
  152.               Real Axis  - _______________|_______________ +
  153.                                           |
  154.                                           |
  155.                                           |
  156.                                           | -     
  157.  
  158.  
  159.              This  program  allows you to examine the  Mandelbrot  region 
  160.              with such detail,  the precision is hard to imagine.  If the 
  161.              full Mandelbrot were the size of the earth,  and you  mapped 
  162.              it down to the smallest grain of sand, you would still be an 
  163.              order  of  magnitude  from  what this program  can  do.   If 
  164.              everyone  in  the  U.S.  were to  be  generating  Mandelbrot 
  165.              blow-ups,   you could quickly find a region to explore which 
  166.              no one  has ever seen before.   In many ways, it carries the 
  167.              excitement  of exploring a new island,  cave or world.   Yet 
  168.              you can do it without leaving your favorite computer.
  169.  
  170.              For more information about the Mandelbrot set, see the August  
  171.              1985 issue of Scientific American.
  172.  
  173.  
  174.                                    PAGE 2 OF 7
  175.  
  176.  
  177.  
  178.  
  179.  
  180.         2.0  DISPLAY - A PICTURE IS WORTH A THOUSAND WORDS
  181.  
  182.              2.1  STARTING THE DISPLAY
  183.                   To Display  a  Mandelbrot  file,  start the  Mandelbrot 
  184.                   program by entering SUPERMAN or  SUPER-87(8087 version
  185.                   only) at the MSDOS prompt.   After a short sign-on, the 
  186.                   program will ask for the filename with  which you  will 
  187.                   work. Enter the name of the .PIC file to be  displayed,
  188.                   e. g., MANDEL, or MANDEL2.    After a filename has been
  189.                   entered, a menu will appear.  The display  function  is
  190.                   selection 3.  Enter a "D" or a "3" and the display pro-
  191.                   gram will load the  selected .PIC file.  If the load is
  192.                   successful, then the coordinates of the  plot are shown
  193.                   and you are asked whether you want to enter the  Break-
  194.                   points manually, or let the computer select them.
  195.  
  196.              2.2  AUTOMATIC BREAKPOINT SELECTION
  197.                   Entering  an "A" will instruct the computer to generate 
  198.                   the Breakpoints.   The computer will attempt to set the 
  199.                   upper limit of the Banding, Breakpoint 1 and Breakpoint 
  200.                   2 that provide the most esthetic  display.   The actual 
  201.                   breakpoints are displayed  to enable you to use them or 
  202.                   change them in the Manual mode.
  203.  
  204.              2.3  MANUAL BREAKPOINT SELECTION
  205.                   Entering an "M" will instruct the computer to allow you 
  206.                   to   enter  your  own  upper  limit  to   Banding   and 
  207.                   Breakpoints.   Thus  one  map can provide thousands  of 
  208.                   possible pictures by simply changing the breakpoints.
  209.  
  210.                   2.3.1  BANDING  - Banding is the name given to the area 
  211.                          away  from  the BLACK  region  which  alternates 
  212.                          between two colors.   The most striking pictures 
  213.                          usually  have banding up to the point where  the 
  214.                          bands would become overly complicated.  Entering 
  215.                          a "0" for TOP of BANDING will disable banding. 
  216.  
  217.                   2.3.2  BREAKPOINTS  - The  two Breakpoints  define  the 
  218.                          position of the transition betweeen colors.  The 
  219.                          area   between  the  TOP  of  BANDING  and   the 
  220.                          Mandelbrot  (BLACK) region is divided into three 
  221.                          colors. The First breakpoint will define the end
  222.                          of  the  color  above the  TOP of BANDING level.
  223.                          The Second Breakpoint will define the transition
  224.                          between Breakpoint 1 and the Mandelbrot  region.
  225.                          As the numbers  increase, the  transition  lines
  226.                          move in  TOWARD  the Mandelbrot.  Lower  numbers
  227.                          push  the colors out  toward  the  border.  When
  228.                          experimenting,  use  the  numbers  given in  the
  229.                          AUTOMATIC selection as starting points.
  230.  
  231.                                    PAGE 3 OF 7
  232.  
  233.  
  234.  
  235.  
  236.  
  237.              2.4  COLOR REDEFINITION
  238.                   The  default mode is for Yellow to be next to the Black 
  239.                   Mandelbrot,  followed  by Red, then Green.   After  the 
  240.                   Breakpoints have been selected, the computer will allow 
  241.                   you  to  change the default sequence by entering a  "C" 
  242.                   for  Colors.   Enter the first character of  the  color 
  243.                   wanted  next to the Mandelbrot,  then the second color.  
  244.                   The  third  color  will be  selected  automatically  by 
  245.                   process of elimination.
  246.  
  247.              2.5  PALETTE AND BACKGROUND
  248.                   The  Palette  of colors for the  area  surrounding  the 
  249.                   Mandelbrot  may  be changed with the  Palette  command.  
  250.                   Entering  a  "P" will allow the choice of  4  different 
  251.                   palettes.    Although   a  different  palette  may   be 
  252.                   selected,  the Color function of section 2.4 will still 
  253.                   respond only to RED,  GREEN and YELLOW.  Entering a "B" 
  254.                   will change the BACKGROUND color.  This is the color of 
  255.                   the Mandelbrot itself, which normally is shown as black.
  256.  
  257.              2.6  THE WINDOW FUNCTIONS
  258.                   The  window function allows you to move a window over a 
  259.                   region of interest which you want to blow up  (create).  
  260.                   After  windowing  in  an  interesting  area,  exit  the 
  261.                   function  with  an  'E' and go to  (C)reate.   The  co-
  262.                   ordinates for the next creation will already be loaded.
  263.                   Simply return carriage through them to leave unchanged.
  264.  
  265.                   2.6.1   PgUp  &  PgDn - The PgUP key will increase  the 
  266.                           size  of  the  window region each  time  it  is 
  267.                           pressed.   Since the window size is zero at the 
  268.                           beginning  of  the Display,  this key  must  be 
  269.                           pressed at least once  to even see the  window.
  270.                           The  PgDn  key will decrease the  size  of  the 
  271.                           window each time it is pressed.   If the window 
  272.                           size goes to zero,  then the window  disappears 
  273.                           from the screen.
  274.  
  275.                   2.6.2   ARROW  - The Arrow keys allow the window to  be 
  276.                           moved throughout the Picture.   The  directions 
  277.                           should be obvious.
  278.  
  279.                   2.6.3   HOME  - The Home key returns the window to  the 
  280.                           exact  center  of the screen and decreases  the 
  281.                           size to zero.
  282.  
  283.                   2.6.4   Ins  & Del - The Ins key increases  the  aspect 
  284.                           ratio of the window.  The Del key decreases the 
  285.                           Aspect ratio of the window.
  286.  
  287.  
  288.  
  289.                                    PAGE 4 OF 7
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                   2.6.5   END - The End key will give the  coordinates of 
  296.                           the window in the upper left hand corner of the 
  297.                           screen.   Thus,  the  window  can be  moved  to 
  298.                           several  interesting  areas and the  exact  co-
  299.                           ordinates noted for each.   Note that it is not 
  300.                           necessary  to  record  the  coordinates  for  a 
  301.                           region  of interest if you want to  immediately 
  302.                           create  the blowup.   Exiting the display  mode 
  303.                           and entering the Create will automatically move 
  304.                           the desired coordinates to Create.
  305.  
  306.              2.7  SAVING A VIEW
  307.                   A  view may be saved by entering an "S" when viewing  a 
  308.                   picture.   A  picture  file can be viewed many ways  by 
  309.                   varying the breakpoints.  A view only stores what is on 
  310.                   the screen,   including the window  and coordinates  if 
  311.                   they  are  visible.   The  view will be stored  as  the 
  312.                   filename.VEW.  Since  more than one view of  any  given 
  313.                   picture may  be worth storing,   the computer will wait 
  314.                   3 seconds for any additional characters you may wish to 
  315.                   be  appended onto the filename when storing  the  view.  
  316.                   If  any  characters are entered during this  time  they 
  317.                   must  be followed by a carriage return before the store 
  318.                   will begin.  
  319.  
  320.              2.8  EXIT
  321.                   Exit the Display by entering an 'E'.   This will return 
  322.                   you to the main Menu.  
  323.  
  324.         3.0  LOADING A VIEW FILE
  325.  
  326.              The  VIEW file stored in paragraph 2.7 may be recalled  from 
  327.              the main menu by entering either a "5" or an "L".   It  will 
  328.              display  the  view stored including any  onscreen  messages,  
  329.              windows,  or coordinates  visible when stored.  The VEW file 
  330.              is useful since it only requires 16K of disk space and loads 
  331.              very quickly.   The time to analyze and generate breakpoints 
  332.              is also saved.
  333.  
  334.         4.0  ANIMATION - THE COMPUTER STORE'S DREAM DEMO
  335.  
  336.              4.1  STARTING THE ANIMATE
  337.                   From  the MAIN MENU enter a "1" or an "A" to start  the 
  338.                   Animation.  See section 2.1 on how to bring up the MAIN 
  339.                   MENU.   You  will be given a choice of using  three  or 
  340.                   four colors in the animate and of animating the picture 
  341.                   toweard  or  away  from  the  center  region.    If  an 
  342.                   Animation  file (.ANI) is found,  it will be read,  and 
  343.                   Animation will begin immediately.  Otherwise, a Picture 
  344.                   (.PIC)  file  will  be retrieved and  converted  to  an 
  345.                   animation file.  This process takes about 3 minutes.
  346.  
  347.                                    PAGE 5 OF 7
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.              4.2  SAVING THE ANIMATE FILE
  355.                   Upon completing generation of an .ANI file from a  .PIC 
  356.                   file,  the  computer  will ask if you want to save  the 
  357.                   .ANI file.   Since an .ANI file will typically be  from 
  358.                   80  to  128K long,  you should make certain  sufficient 
  359.                   disk space is available.  A message of "UNABLE TO WRITE 
  360.                   FILE" is an indication of a full disk.
  361.  
  362.              4.3  PALETTE, BACKGROUND COLORS and SPEED
  363.                   As with the DISPLAY function,  the Palette (colors) can 
  364.                   be  changed by entering a "P",  and the backgound color 
  365.                   can be changed by entering a "B". Since the Computer is 
  366.                   very  busy  with the animate,  it can  only  check  for 
  367.                   inputs  about  every three seconds.   However  it  will 
  368.                   process  all pending instructions during each  inquiry.  
  369.                   Enter a 0 through 9 will vary the speed of the ANIMATE.
  370.  
  371.              4.4  EXITING
  372.                   As with the DISPLAY mode,  exiting the function is done 
  373.                   by  entering  an "E".   This can be done  either  while 
  374.                   generating an .ANI file from a .PIC file,  or while the 
  375.                   actual animate is being performed.
  376.  
  377.         5.0  CREATING A NEW MANDELBROT PLOT - LIKE BEING AN EXPLORER
  378.  
  379.              5.1  STARTING THE CREATE
  380.                   Enter the Create function by either entering a "2" or a 
  381.                   "C"  from  the MAIN MENU.   Refer to 2.4 to get to  the 
  382.                   MENU.   You may want to change the filename which is in 
  383.                   the MAIN MENU.   This is done by entering either a  "0" 
  384.                   or  an "F".   The create function will present a second 
  385.                   menu.
  386.  
  387.                   The  CREATE function will typically take about 8 to  12 
  388.                   hours  when MANDEL is used.   If MANDEL87 is  used, the 
  389.                   create time is typically 10 to 15 minutes. However, you 
  390.                   MUST  have  an  8087 installed when  running  the  8087 
  391.                   version or your system will crash.
  392.  
  393.              5.2  AUTOMATIC COORDINATES
  394.                   The  coordinates of the  section to be blown up will be 
  395.                   shown  if you have previously windowed an area  in  the 
  396.                   Display mode.   If you want  to use these  coordinates, 
  397.                   then simply enter a carriage return for each.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.                                    PAGE 6 OF 7
  406.  
  407.  
  408.  
  409.  
  410.  
  411.              5.3  ENTERING THE COORDINATES
  412.                   If  you haven't windowed an area of interest,  then the 
  413.                   coordinates  displayed will  be the coordinates of  the 
  414.                   last Picture displayed.  If nothing has been displayed, 
  415.                   then  the coordinates  will be the  default coordinates 
  416.                   for the entire Mandelbrot.   In either case,  you  will 
  417.                   need   to   enter  the  coordinates  for  the   desired 
  418.                   Mandelbrot.   Remember, the Lower Real defines the left 
  419.                   side,  the  upper  real  the  right  side.   The  Lower 
  420.                   Imaginary  defines the bottom and the  Upper  Imaginary 
  421.                   defines  the  top.   Reversing of the coordinates  will 
  422.                   reverse the picture generated.   The file to which  the 
  423.                   Mandelbrot  will  be written will be displayed  at  the 
  424.                   bottom and cannot be changed here. 
  425.  
  426.              5.4  FILENAME CONFLICTS
  427.                   If the file selected already exists,  then the computer 
  428.                   will ask if you wish to erase the old file.  A response 
  429.                   of "N" will return you to the MAIN MENU.  If you make a 
  430.                   mistake setting up the Create,  it can be aborted after 
  431.                   it starts by entering an "E".   When aborted, any files 
  432.                   with  the  same  name  are  not  erased  even  if   you 
  433.                   previously answered with a "Y".
  434.  
  435.  
  436.  
  437.  
  438.  
  439.                       (C) COPYRIGHT 1985 by Marshall Dudley
  440.  
  441.                Feel  free to copy  and upload  the public  domain
  442.                versions of  SUPERMAN.   The source  code and 8087
  443.                versions of  SUPERMAN are  not public  domain  and 
  444.                duplication,  except  for the express  purpose  of 
  445.                backup  is  expressly prohibited.   This  is  true 
  446.                whether  you  received the software on disk or  it 
  447.                was  transmitted to you via Modem.   No  warranty, 
  448.                either  implicit  or  implied,  is made  for  this 
  449.                software.   No  liability  shall  be  assumed  for 
  450.                direct  or  consequential damage  caused  by  this 
  451.                software.  Our only guarantee is that there are no 
  452.                intentional  bugs,  and  if any fatal  errors  are 
  453.                found, the disk will be replaced free of charge.
  454.  
  455.                              TriMark Engineering
  456.                              12402 W. Kingsgate Dr.
  457.                              Knoxville, Tn. 37922
  458.  
  459.                              Compuserve ID# 72416,3357
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                    PAGE 7 OF 7
  467.